home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48hor2 / xpndr.doc < prev    next >
Text File  |  1995-03-31  |  5KB  |  118 lines
  1. (Comp.sys.hp48) 
  2. Item: 2434 by fee@waikato.ac.nz [Conan J. Fee] 
  3. Subj: XPNDR - A menu & softkey expander util 
  4. Date: 21 Dec 1992 
  5.  
  6. Hello all. 
  7.  
  8. Here is a Christmas present - a utility which I just finished developing 
  9. (with the help of Detlef Muller). Basically, as the attached documentation 
  10. shows, it is a utility for expanding the current menu and providing more 
  11. than the standard 6 menu softkeys (up to 36, to be exact). It is VERY 
  12. simple to operate (self-explanatory) and doesn't take up much room. Try it. 
  13.  
  14. I posted this to comp.sources.hp48 but that newsgroup is empty right 
  15. now, and there is no indication as to when it will be updated. 
  16.  
  17. Enjoy. 
  18.  
  19. Regards,  
  20. Conan. 
  21.  
  22. [Note: Also see XMENU for an alternate approach.  -jkh-] 
  23.  
  24. --------------------------- 
  25. Begin XPNDR.DOC                        
  26.                                 XPNDR v1.0 
  27.                                     by 
  28.                                 Conan J. Fee                           
  29.                         University of Waikato, Hamilton, 
  30.                                 New Zealand.                           
  31.                         email: fee@waikato.ac.nz   
  32.  
  33. DESCRIPTION:  XPNDR version 1.0 is a utility which shows all pages of 
  34. the current menu on screen at once  and allows you to choose any of 
  35. the menu functions by pressing a key ie: you now have up to  six rows 
  36. of softkeys, not just the first row. 
  37.  
  38. If you have ever had to search through several pages of an unfamiliar 
  39. menu in search of the command you want, not known whether to press NXT 
  40. or PREV to get the menu page you want, or not known whether the 
  41. programming command you seek is in the TEST, BRANCH or CONTROL menu, 
  42. let alone which page, then XPNDR is for you! 
  43.  
  44. OPERATION:  Assign XPNDR to a user key (I use BLUE-NXT) and then 
  45. whenever you execute XPNDR,  you will see all pages (six pages 
  46. maximum) of the current menu, whether it is a library, a user 
  47. directory or a built-in menu such as the MTH menu, shown on screen at 
  48. once. 
  49.  
  50. The first four rows of keys then act as softkeys for the corresponding 
  51. functions.  If the menu has more than 4 pages (this is rare for 
  52. built-in menus, but try it with the STATS  menu), on-screen 
  53. instructions tell you what to do.  If you press a key that doesn't 
  54. correspond to a function - no problem. XPNDR quits without  taking 
  55. action.  XPNDR not only executes the function shown but works as a 
  56. typing aid and works with all  shift planes. 
  57.  
  58. Try it to convert units, to recall a variable's contents or to store an  
  59. object in a  user-variable. ie: it works the same as softkeys.  
  60.  
  61. It's that simple!   
  62.  
  63. INSTALLATION:   
  64. 1. Download XPNDR to your HP48. 
  65. 2. Store the resulting directory wherever you like. 
  66. 3. Enter the directory, recall the contents of XPNDR to the stack and store 
  67.         it as XPNDR in the  home directory.  
  68. 4. Recall (don't evaluate) the contents of SETUP to the stack - you 
  69.         should get the name  XPNDR on the stack.  
  70. 5. Assign the result of 4, above, to whatever key you like (I think BLUE-NXT 
  71.         is a pretty  logical choice).  
  72. 6. Purge everything except the copy of XPNDR in the home directory. 
  73.  
  74. Away you go!   
  75.  
  76. NOTE: Please use SETUP to put the name XPNDR on the stack for assigning to  
  77. a key -  merely entering the name 'XPNDR' from the keyboard will not  
  78. allow XPNDR to function  correctly. (The contents of SETUP are actually 
  79. a sys_RPL routine with source code  comprised of :: TakeOver ID XPNDR ;)  
  80.  
  81. ACKNOWLEDGEMENT:  Thanks VERY much to Detlef Muller for his absolutely  
  82. invaluable help and suggestions in  working out this routine. Detlef -  
  83. you're a marvel!   
  84.  
  85. SUGGESTIONS: You'll notice the routine is a little slow (but still faster  
  86. than searching individual menu pages), especially for more than 4 menu pages.  
  87. This is virtually unavoidable for sys_RPL, since the menu grobs are not  
  88. stored internally but must be redrawn each time a new menu page is  
  89. displayed.   
  90.  
  91. Anyone who is a machine-code ace can probably speed this up a bit.  
  92. Feel free to do this and  please let me have a copy.   
  93.  
  94. The maximum number of menu pages is six - this is because the routine  
  95. would get  cumbersome, large, slow and require more interaction from the  
  96. user to get more than this number of functions on-screen at once. I  
  97. don't think the extra complexity is worth it for the  very few menus that  
  98. might have more than six pages. If you disagree, you are welcome to  modify  
  99. the routine. Just let me know if you do.  
  100.  
  101. DISCLAIMER:  This routine is provided free and without any warantee 
  102. whatsoever. 
  103.  
  104. You don't have to use this  and I don't want to be sued for providing  
  105. freeware!!! (On the other hand, if you're the litigious  type and you're  
  106. really bent on suing me despite this disclaimer, go ahead - you're welcome  
  107. to  take over every cent of my substantial overdraft.)  
  108.  
  109. REPORT: Bugs, comments and suggestions to me via email:fee@waikato.ac.nz 
  110.  
  111.  
  112. ----------------------------------------------------------------- 
  113. Conan J. Fee                        _      fee@waikato.ac.nz 
  114. Centre for Technology              (_)o     
  115. University of Waikato, Hamilton    /\  \   Phone: +(64)(7)8384206 
  116. Private Bag 3105, New Zealand              Fax:   +(64)(7)8384324 
  117. ----------------------------------------------------------------- 
  118.